Inside Macintosh: QuickDraw GX Objects /

Chapter 2 - Shape Objects / Shape Objects Reference

Functions / Creating and Manipulating Shape Objects

GXDisposeShapeCache

You can use the GXDisposeShapeCache function to release the memory occupied by a shape's cache.

void GXDisposeShapeCache(gxShape target);

target

A reference to the shape whose cache is to be disposed of.

DESCRIPTION

The GXDisposeShapeCache function immediately releases the memory allocated to the cache of the shape indicated by the target parameter. This function releases only that memory allocated to the target shape's cache. It does not release memory allocated to any related system caches or globals.

To build a shape cache, use the GXCacheShape function. To delete a shape cache, use this function. To determine the amount of memory occupied by a shape cache, use the GXGetShapeCacheSize function.

SPECIAL CONSIDERATIONS

You never need to call this function. QuickDraw GX disposes of caches automatically when it needs additional memory.

ERRORS, WARNINGS, AND NOTICES

Errors
shape_is_nil

SEE ALSO

Shape caches are discussed in the section "Caching Shape Objects" beginning on page 2-27. The GXCacheShape function is described on page 2-62. The GXGetShapeCacheSize function is described in the next section.